home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 September / Software of the Month Club 1996 September.iso / pc / os2 / initor / readme.1st < prev   
Encoding:
Text File  |  1996-07-05  |  10.1 KB  |  268 lines
  1. ┌─────────────────────────────────────────────────────────────────────────┐
  2. │ Initor 1.1 ( INIfile ediTOR )                                           │
  3. │                                                                         │
  4. │ OS2 Ini File Editor                                                     │
  5. │ CopyRight (C) 1996 Jobst Schmalenbach                                   │
  6. │ Email: jhs@dgs.monash.edu.au                                            │
  7. │                                                                         │
  8. │ Snail Mail:  Jobst Schmalenbach                                         │
  9. │              19 York Street                                             │
  10. │              Caulfield South, VIC, 3162                                 │
  11. │              Australia                                                  │
  12. │                                                                         │
  13. │ Parts of the source code were taken from:                               │
  14. │              Real World Programming for OS/2                            │
  15. │              Copyright (c) 1993 Blain, Delimon, and English             │
  16. │                                                                         │
  17. │Thank you, guys. The book is excellent!                                  │
  18. │Learned very quick and necessary stuff!                                  │
  19. └─────────────────────────────────────────────────────────────────────────┘
  20.  
  21. This file and the GNU LICENCE must be kept together with the INITOR.
  22. (If not may your inner conscious slowly crawling up you back!)
  23.  
  24. This program is free software; you can redistribute it and/or modify
  25. it under the terms of the GNU General Public License as published by
  26. the Free Software Foundation; either version 1, or (at your option)
  27. any later version.
  28.  
  29. This program is distributed in the hope that it will be useful,
  30. but WITHOUT ANY WARRANTY; without even the implied warranty of
  31. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  32. GNU General Public License for more details.
  33.  
  34. You should have received a copy of the GNU General Public License
  35. along with this program; if not, write to the Free Software
  36. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  37.  
  38. ___________________________________________________________________________
  39.  
  40.  
  41. WHAT DOES THIS PROGRAM DO?
  42. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  43. Initor enables you to edit OS2 "ini" files. You are able to add, deleted 
  44. and edit applications, keys and key data.
  45.  
  46. DO NOT USE THIS PROGRAM IF YOU DONT KNOW WHAT YOU ARE DOING!!!!
  47. I take no responsibilty if you bugger up your ini files and I have NOT
  48. included "safety keys" into the application. 
  49.  
  50. BUT: therefore its very fast and efficient!
  51.  
  52. I have written this program because the LOTUS ini file editor drove me nuts,
  53. You cannot size it to a different window size, it comes up with
  54. this silly window at startup and does not remember the last directory were
  55. you edited a file. So I used the basic structure of Real World Programmings
  56. ini file editor and changed a few things and bugs to make INITOR.
  57.  
  58.  
  59. HOW DOES IT WORK?
  60. ~~~~~~~~~~~~~~~~~
  61. Simply start INITOR from the command line or have an icon pointing to this
  62. program somewhere on the desktop. Refer to the OS2 help files how to make
  63. a program icon.
  64.  
  65. Initor starts with the "OS2.INI" (USERINI) file opened.
  66.  
  67. After a few uses you get the idea.....
  68.  
  69.  
  70. CHANGING INI FILES:
  71. ~~~~~~~~~~~~~~~~~~~
  72. If you want to change to another INI file click on "PROFILES" (alt-p).
  73.  
  74. You can choose:
  75.   - USER INI FILE (os2.ini)
  76.   - SYSTEM INI FILE (os2sys.ini)
  77.   - USER AND SYSTEM FILE (above together)
  78.   - Other INI files (this could be for example AmiPro's INI FILES)
  79.  
  80. If you click on USER or SYSTEM file the user and/or system ini file are opemed
  81. as set in the enviromental variable which must be set in the config.sys file.
  82.  
  83. If you choose "Other .." a file dialog box is opened with the directory shown
  84. where INITOR was started up. If you save the path as shown below "Saving ..."
  85. the next time you open INITOR the file dialog box opens with the same path.
  86.  
  87.  
  88. MOVING AROUND:
  89. ~~~~~~~~~~~~~~
  90. You simply click on an application to go to another application in the
  91. "Application Name" Window using scroll bars as well.
  92. All key names of that application will be displayed in the "Key Name" window.
  93. The data of the first key will be displayed in HEX and ASCII.
  94.  
  95. If you need another key, click on another key and the new data will be 
  96. displayed with offset and the number of bytes in HEX and ASCII.
  97.  
  98.  
  99. EDIT KEYS AND KEY DATA:
  100. ~~~~~~~~~~~~~~~~~~~~~~~
  101. If you need to change data of an  application use "Edit Application" (alt-e).
  102. A Dialog box will appear with the application name in the first row,
  103. the key name in the second row and the key data last.
  104.  
  105. You cannot change the application name, that is set read only but you can
  106. change the key name and the data.
  107.  
  108. The first dialog box is for ASCII strings with values above 32 and below
  109. 127 (ASCII). If key data is shown with values below 32 you can click
  110. on "HEX" button and another dialog box appears to be able to change
  111. binary data.
  112.  
  113.  
  114. HEX DATA EDITING:
  115. ~~~~~~~~~~~~~~~~~
  116. If you clicked on the HEX button in the "ADD-EDIT" dialog box above a
  117. dialog box appears to edit hex (binary) data. Just edit data
  118. as required keeping a space between each BYTE and use 
  119. HEX and BINARY numbers to enter data into the window.
  120.  
  121. You must keep a space between each byte or else your data will not
  122. be accepted. The box will stay until the data is accepted 
  123. or you press CANCEL.
  124.  
  125. You must end the data in the hex window with a "00" and a space. 
  126. The "00" is part of the key data in the ini files and the space
  127. is the programs way to determine a byte separated from another byte.
  128. I dont think this is a major problem although it might seem a little
  129. awkward in the first place.
  130.  
  131.  
  132. DELETING APPLICATIONS AND KEYS:
  133. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  134. If you need to delete a key or application click on "Delete Items" (alt-i).
  135.  
  136. "Delete Application" will delete the applcation pointed at with all keys 
  137. belonging to THAT application and the data belonging to the keys.
  138. An application example:  "AMIUSER" in the provided test.ini!
  139.  
  140. "Delete Selected Key" will only destroy the key and the data.
  141. A key example of above application:  "BackUpPath"
  142. Data for the above key:              "d:\tmp"
  143.  
  144. You are asked for confirmation to delete the key/application.
  145.  
  146.  
  147. ADDING APPLICATIONS AND KEYS:
  148. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  149. If you need to add a new application or add a key to an existing 
  150. application choose "Add Items" (alt-i).
  151.  
  152. "Add new application" adds a new application to the ini file. An 
  153. application is for example "AmiPro". If you add a new application 
  154. it will be sorted alphabetically (not in the ini file).
  155.  
  156. "Add new key" adds a new KEY to the current application pointed at.
  157. A new key would be for example "INIPATH" (data in my case: d:\os2).
  158.  
  159.  
  160. SAVING DATA AND SCREEN LOCATION:
  161. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  162. If you want to save the data you have changed, added or deleted, want to save 
  163. your screen location and save your last path click on "SAVE" (alt-s).
  164.  
  165. You can save changes to the data by selecting "Changes".
  166. You can save the window location (quite handy) by selecting "Screen Location".
  167. You can save the last path by selecting "PATH"
  168.  
  169. I DOES NOT WRITE ANYTHING TO YOUR INI FILES BEFORE YOU TELL IT TO DO SO.
  170. (and if you want to delete it, well, you've got the toold now...)
  171.  
  172.  
  173. NOTE:
  174. ~~~~~
  175. Note that this editor was written with speed in mind. I am looking 
  176. after a few systems (LanServer 4.0 etc) and needed a quick ini editor 
  177. to change a few settings to make a few applications "behave" a little better. 
  178. I got frustrated with LOTUS ini editor because it doesn't remember the last path,
  179. screen location and comes up with this box at startup telling you its dangerous
  180. to change something in you ini files.
  181.  
  182. So I wrote this one and use it (and a few friends too) nearly every day.
  183.  
  184. An I left out a few things to make this program faster to work with
  185. and not have to press too many buttons.
  186.  
  187.  
  188. TEST INI FILE:
  189. ~~~~~~~~~~~~~~
  190. I have included a test ini file which you can load an try out a few things 
  191. before you want to change the "real" ones. It has a number of applications,
  192. keys and key data in it. The file is taken from my LOTUS AmiPro.
  193.  
  194. It is the "AMIUSER3.INI" files which contains all the setttings of a user.
  195.  
  196. The first APPLICATION is the "AMIUSER" in that file.
  197. A KEY is for example the "BACKUPPATH" and the KEYDATA is "H:\AMIPRO\TMP"
  198. (AmiPro's direcotry on my machine is on "H").
  199.  
  200. Try a few things here and you get the idea.
  201.  
  202.  
  203. BUGS:
  204. ~~~~~
  205. I dont know of any bug (hopefully).
  206.  
  207. I tested this thouroughly and it worked fine with me and one other person.
  208. It has run on a number of systems with different types of WARP installed.
  209. Warp plain, Warp fixpak5, Warp fixpak10, Warp fixpak17.
  210.  
  211. This program, however, is not fancy. 
  212. It is straight to the point and useful for somebody do some work quickly.
  213.  
  214. Bug reports to the author. Email: jhs@dgs.monsh.edu.au
  215.  
  216.  
  217. FUTURE ENHANCEMENTS:
  218. ~~~~~~~~~~~~~~~~~~~~
  219. I try to include IPFS help into the editor.
  220. ....
  221. ....
  222.  
  223.  
  224. SUGGESTIONS:
  225. ~~~~~~~~~~~~
  226. Very wellcome. Semd me some EMAIL: jhs@dgs.monsh.edu.au
  227.  
  228.  
  229. HISTORY:
  230. ~~~~~~~~
  231. June 1996: INITOR 1.0
  232. June 1996: INITOR 1.1
  233.             - added very simple help menu (shows readme file).
  234.             - added abilty to edit and add BINARY data (hex data).
  235.             - fixed last path saved (path was cut off when longer the 20).
  236.             - fixed redraw when canceling add/edit dialog box.
  237.             - fixed some data appearing in key data window when adding new key.
  238.             - fixed some data appearing in key data window when adding new application.
  239.  
  240.  
  241. WHY I USE GNU LICENSE?
  242. ~~~~~~~~~~~~~~~~~~~~~~
  243. Well, easy. I use a lot of the GNU stuff:
  244.   GTAK, GTAR, emacs, gcc, gnu utils, emtex, ghostview 
  245.   and many many more.
  246.  
  247. So why should Imake some available? (some more to come..)
  248.   
  249.  
  250. AUTHOR:
  251. ~~~~~~~
  252. Jobst Schmalenbach
  253. 19 York Street
  254. Caulfield South, VIC, 3162
  255. Australia
  256.  
  257. 61  3 9523 7348
  258. 61 41 141  6843
  259.  
  260. EMAIL: jhs@dgs.monash.edu.au
  261.  
  262.  
  263.  
  264.  
  265. ~~~~~~~~~~~~
  266. ENJOY!
  267.  
  268.